home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / archive / userbox / publicdomain / superviewel.lha / SuperViewEL / SuperViewLibrary / Docs / ControlPads next >
Text File  |  1996-06-18  |  23KB  |  370 lines
  1.  
  2.   ControlPad-FAQ V13.2 (15.6.96)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.   List has been sorted alphabetically and by module types
  6.   (information has been derived from docs basing on CPInfo-Files).
  7.  
  8.   ============================================================================
  9.   MAIN LIBRARIES
  10.   ----------------------------------------------------------------------------
  11.   ControlPad-Name     : "ENV:superview-library/LIBRARY.controlpad"
  12.   ControlPad-Commands : - DEFAULTSVDRIVER=<#?.svdriver>
  13.                           ; Which SVDriver should be set, when
  14.                           ; superview-library is beeing initialized ?
  15.                           ; For example: "DEFAULTSVDRIVER=AGA.svdriver"
  16.                         - ANYDATATYPES
  17.                           ; if this KeyWord is set, ANY DataTypes will
  18.                           ; be loaded and tried to be displayed in some
  19.                           ; way (e.g. not only pictures, but also 8SVX
  20.                           ; sounds or ANIM-Files ...)
  21.                           ; This changes are recognized each time, when
  22.                           ; a new handle for loading a file is being
  23.                           ; initialized - but may be superseded by specific
  24.                           ; program's settings internally.
  25.   ----------------------------------------------------------------------------
  26.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  27.   ControlPad-Commands : - C2P=<OS|SV>
  28.                           ; determines, whether chunky to planar conversion
  29.                           ; is managed via the appropriate OS functions
  30.                           ; or via internal ones.
  31.                           ; Due to various problems with the OS functions
  32.                           ; "SV" is now default.
  33.                           ; Be careful when using "OS" with GfxCards,
  34.                           ; which carelessly patched graphics.library.
  35.   ============================================================================
  36.   SVOBJECTS
  37.   ----------------------------------------------------------------------------
  38.   ControlPad-Name     : "ENV:superview-library/AmiFIG.controlpad"
  39.   ControlPad-Commands : - AMIFIG_PATH=<fig2dev command path and/or name>
  40.                           ; how fig2dev is to be called
  41.                           ; e.g. AMIFIG_PATH=Work:AmiFIG/fig2dev
  42.                           ; default is: fig2dev
  43.   ----------------------------------------------------------------------------
  44.   ControlPad-Name     : "ENV:superview-library/EPS.controlpad"
  45.   ControlPad-Commands : - EXTRACTMODE=<HEADER|PS>
  46.                           ; Determines, whether the preview image or
  47.                           ; the Postscript (TM) part should be extracted,
  48.                           ; while parsing the Postscript (TM) part requires
  49.                           ; a working Ghostscript installation with
  50.                           ; GhostScript.svobject being correctly configured
  51.                           ; default is: HEADER
  52.                         - SAVE_ROTATE=<ON|OFF>
  53.                           ; by default, the picture seems to be rotated
  54.                           ; with Postscript (TM) output of this module.
  55.                           ; Enabling SAVE_ROTATE will again re-rotate it to
  56.                           ; the original position.
  57.                           ; default is: OFF
  58.                         - SAVE_CENTER=<ON|OFF>
  59.                           ; centers the images on the page with the
  60.                           ; desired size of SAVE_WIDTH x SAVE_HEIGHT (or not)
  61.                           ; default is: ON
  62.                         - SAVE_RLE=<ON|OFF>
  63.                           ; allows to apply RLE compression to the
  64.                           ; PS output
  65.                           ; default is: OFF
  66.                         - SAVE_DPI=<value>
  67.                           ; DPI value to use for the output
  68.                           ; default is: 300
  69.                         - SAVE_WIDTH=<value>
  70.                           ; Width of the PS page
  71.                           ; default is: 612
  72.                         - SAVE_HEIGHT=<value>
  73.                           ; Width of the PS page
  74.                           ; default is: 762
  75.   ----------------------------------------------------------------------------
  76.   ControlPad-Name     : "ENV:superview-library/FastILBM24.controlpad"
  77.   ControlPad-Commands : - BUFFERSIZE=<Size in Bytes>
  78.                           ; how many bytes should be buffered
  79.                             (more = faster)
  80.                           ; Default is 8192, minimum is 256
  81.                         - PASSTHROUGH
  82.                           ; do not recognize ANY pictures, so that
  83.                           ; they e.g. might be passed through to
  84.                           ; ILBM.svobject instead
  85.                         - DITHERMODE=<HAM6_QUICK|HAM8_QUICK>
  86.                           ; Default is HAM6_QUICK
  87.   ----------------------------------------------------------------------------
  88.   ControlPad-Name     : "ENV:superview-library/GhostScript.controlpad"
  89.   ControlPad-Commands : - GS_PATH=<gs command path and/or name>
  90.                           ; how GhostScript is to be called
  91.                           ; e.g. GS_PATH=Ghostscript:gs000
  92.                           ; default is: gs000
  93.                         - OUTPUTMODE=<PNG256|PNG24BIT>
  94.                           ; Output file format to be used
  95.                           ; (-sDEVICE parameter of GhostScript's gs).
  96.                           ; Only PNG supported yet.
  97.                           ; default is: PNG256
  98.                         - DPI=<value>
  99.                           ; DPI value to use for the converted output
  100.                           ; (-r parameter of GhostScript's gs)
  101.                           ; default is: 72
  102.   ----------------------------------------------------------------------------
  103.   ControlPad-Name     : "ENV:superview-library/GIF.controlpad"
  104.   ControlPad-Commands : - GIF89A_TRANSPARENT_COLOR=<0..255>
  105.                           ; Default color to be enabled and set
  106.                           ; (graphics control extension block)
  107.                           ; Default: (not active)
  108.   ----------------------------------------------------------------------------
  109.   ControlPad-Name     : "ENV:superview-library/ILBM.controlpad"
  110.   ControlPad-Commands : - ANIM_BODIES
  111.                           ; if set, ANIM files' ILBM-BODY chunks
  112.                           ; (first frame) will be extracted when
  113.                           ; such a file is encountered. Otherwise
  114.                           ; ANIM.datatype may do that task later.
  115.   ----------------------------------------------------------------------------
  116.   ControlPad-Name     : "ENV:superview-library/JPEG.controlpad"
  117.   ControlPad-Commands : - COLORDEPTH=<8|24>
  118.                           ; For READING colored 24 Bit images:
  119.                           ; should the output be done as 8 or 24 Bit Data ?
  120.                           ; default is 8 Bit data. Grayscaled graphics
  121.                           ; will _always_ be exported as 8 Bit
  122.                         - FORCE_GRAY_DECODE
  123.                           ; For READING images:
  124.                           ; this switch overrides the selected depth
  125.                           ; for colored images and always exports them
  126.                           ; as 8 Bit grayscaled pictures
  127.                           ; default is: not set
  128.                         - DECODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  129.                                          FLOATING_POINT|FASTEST_INTEGER>
  130.                           ; For READING images:
  131.                           ; how to DECODE the 24 Bit or gray data
  132.                           ; default is: FAST_INTEGER
  133.                         - DITHERMODE=<DITHER_FLOYD-STEINBERG|
  134.                                       NO_DITHERING|DITHER_ORDERED>
  135.                           ; For READING and dithering 24 Bit images
  136.                           ; to 8 Bit images:
  137.                           ; how and whether to DITHER the 24 Bit data
  138.                           ; default is: DITHER_FLOYD-STEINBERG
  139.                         - COLOR_QUANTIZING=<FAST|SLOW>
  140.                           ; For READING and dithering 24 Bit images
  141.                           ; to 8 Bit images:
  142.                           ; whether to QUANTIZE the 24 Bit data within
  143.                           ; two passes
  144.                           ; default is: SLOW
  145.                         - UPSAMPLING=<ON|OFF>
  146.                           ; For READING and dithering 24 Bit images
  147.                           ; to 8 Bit images:
  148.                           ; whether to do fancy upsampling on the 24 Bit
  149.                           ; default is: ON
  150.                         - QUANTIZATION=<0..100>
  151.                           ; For WRITING 8/24 Bit images as 24 Bit JPEG:
  152.                           ; 0   - poor quality, big compression
  153.                           ; 100 - best quality, no compression
  154.                           ; never use such extreme values, but try
  155.                           ; something like 20, 50, 75
  156.                           ; default is: 75)
  157.                         - FORCE_GRAY_ENCODE
  158.                           ; For WRITING images:
  159.                           ; this switch causes grayscales to be written
  160.                           ; no matter, whether the input was colored
  161.                           ; default is: not set
  162.                         - ENCODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  163.                                          FLOATING_POINT|FASTEST_INTEGER>
  164.                           ; For WRITING images:
  165.                           ; how to ENCODE the 24 Bit or gray data
  166.                           ; default is: FAST_INTEGER
  167.                         - OPTIMIZE=<ON|OFF>
  168.                           ; For WRITING 24 Bit images:
  169.                           ; whether to optimize the generated huffman
  170.                           ; code (good compression, but slow)
  171.                           ; default is: OFF
  172.                         - PROGRESSIVE=<ON|OFF>
  173.                           ; For WRITING 24 Bit images:
  174.                           ; whether to write progressive JPEG files
  175.                           ; default is: OFF
  176.   ----------------------------------------------------------------------------
  177.   ControlPad-Name     : "ENV:superview-library/PCD.controlpad"
  178.   ControlPad-Commands : - OUTPUTFORMAT=<BASE/16 | BASE/4 | BASE >
  179.                           ; specifies the output resolution to be used
  180.   ----------------------------------------------------------------------------
  181.   ControlPad-Name     : "ENV:superview-library/SVG.controlpad"
  182.   ControlPad-Commands : - PACKMETHOD=<xxxx>
  183.                           ; if this one is specified, it is tried to
  184.                           ; pack the resulting file with the specified
  185.                           ; XPK-Packer. If this fails, the file keeps
  186.                           ; unpacked.
  187.   ============================================================================
  188.   SVDRIVERS
  189.   ----------------------------------------------------------------------------
  190.   ControlPad-Name     : "ENV:superview-library/AGA.controlpad"
  191.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  192.                           ; (case-sensitive, ".svoperator" may be added)
  193.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  194.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  195.                           ; specifies, which operation should be performed
  196.                           ; on 24 Bit graphics _before_ displaying them
  197.                           ; (if not specified, "best guess" colors will
  198.                           ;  be used, which is really slow)
  199.                         - BITMAPCOPY=<DIRECT|RTG>
  200.                           ; "BITMAPCOPY=RTG" prevents AGA.svdriver from
  201.                           ; directly copying into Bitmaps, which will
  202.                           ; result in a usage of more memory, but keeps it
  203.                           ; working.
  204.                           ; Default is "BITMAPCOPY=DIRECT".
  205.                         - SCREENINFRONT
  206.                           ; Put Screen to front _before_ the graphics
  207.                           ; has been displayed (useful with GfxCards)
  208.   ----------------------------------------------------------------------------
  209.   ControlPad-Name     : "ENV:superview-library/ECS.controlpad"
  210.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  211.                           ; (case-sensitive, ".svoperator" may be added)
  212.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  213.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  214.                           ; specifies, which operation should be performed
  215.                           ; on 24 Bit graphics _before_ displaying them
  216.                           ; (if not specified displaying will fail)
  217.                         - 8BITOPERATOR=<OperatorName>
  218.                           ; (case-sensitive, ".svoperator" may be added)
  219.                           ; e.g. "8BITOPERATOR=ExtractGrayScales"
  220.                           ; specifies, which operation should be performed
  221.                           ; on non-ECS graphics (more than 16 Colors in
  222.                           ; HighRes, more than 32 Colors in LowRes, HAM8)
  223.                           ; (if not specified, will be tried to display)
  224.                         - BITMAPCOPY=<DIRECT|RTG>
  225.                           ; "BITMAPCOPY=RTG" prevents ECS.svdriver from
  226.                           ; directly copying into Bitmaps, which will
  227.                           ; result in a usage of more memory, but keeps it
  228.                           ; working.
  229.                           ; Default is "BITMAPCOPY=DIRECT".
  230.                         - SCREENINFRONT
  231.                           ; Put Screen to front _before_ the graphics
  232.                           ; has been displayed (useful with GfxCards)
  233.   ----------------------------------------------------------------------------
  234.   ControlPad-Name     : "ENV:superview-library/CyberGraphics.controlpad"
  235.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  236.                           ; beginning depth for opening CyberGraphics Screens
  237.                           ; Default is 16 Bit (which will also be tried
  238.                           ; when opening of a 24 Bit Screen fails)
  239.                           ; This does not concern colordepths < 16 Bit,
  240.                           ; except HAM6/8.
  241.                         - SMALLSCREENS
  242.                           ; unless this KeyWord is specified, it is not
  243.                           ; tried to open screens smaller than 320x240
  244.   ----------------------------------------------------------------------------
  245.   ControlPad-Name     : "ENV:superview-library/PicassoII.controlpad"
  246.   ControlPad-Commands : - SMALLSCREENS
  247.                           ; unless this KeyWord is specified, it is not
  248.                           ; tried to open screens smaller than 320x240
  249.                         - BLITTER
  250.                           ; uses the Picasso blitter to copy graphics
  251.                           ; into screens. Otherwise CPU is used.
  252.                           ; On 68000 systems you may wish to use the blitter
  253.                         - EMUSCREENDEPTH=<16|24>
  254.                           ; beginning depth for opening Picasso Screens
  255.                           ; Default is 24 Bit (if opening fails, it is
  256.                           ; also tried to open a 16 Bit Screen, then)
  257.                         - SCREENMODEREQUEST
  258.                           ; if this one is specified, the SVDriver ITSELF
  259.                           ; will open a ScreenMode-Requester and ask
  260.                           ; for an appropriate Screenmode to use
  261.                           ; Useful, if you always like to change modes.
  262.                         - AUTOSCROLLADJUST
  263.                           ; this keyword will force Autoscroll whenever
  264.                           ; it would make sense, but the Picasso Software
  265.                           ; would not manage it by itself (when either
  266.                           ; only width or height need to be autoscrolled)
  267.   ----------------------------------------------------------------------------
  268.   ControlPad-Name     : "ENV:superview-library/Retina.controlpad"
  269.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  270.                           ; beginning depth for opening Retina Screens
  271.                           ; Default is 24 Bit (if opening fails, it is
  272.                           ; also tried to open a 16 Bit Screen, then)
  273.   ============================================================================
  274.   SVOPERATORS
  275.   ----------------------------------------------------------------------------
  276.   ControlPad-Name     : "ENV:superview-library/24BitToHAM.controlpad"
  277.   ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL
  278.                                       |HAM8_QUICK|HAM8_WELL>
  279.                           ; specifies the HAM-Mode to be used and
  280.                           ; the resulting speed/quality
  281.   ----------------------------------------------------------------------------
  282.   ControlPad-Name     : "ENV:superview-library/CallPNM24.controlpad"
  283.   ControlPad-Commands : - PNMCOMMAND=<PBM command path and name>
  284.                           ; PNM command to be called
  285.                           ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale
  286.                         - PNMOPTIONS=<Options>
  287.                           ; Options for PNM command to be called
  288.                           ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0
  289.   ----------------------------------------------------------------------------
  290.   ControlPad-Name     : "ENV:superview-library/Crop.controlpad"
  291.   ControlPad-Commands : - CROP_LEFTEDGE=<Value>
  292.                           ; crop from x position
  293.                           ; (will be adjusted, if >= source width)
  294.                         - CROP_TOPEDGE=<Value>
  295.                           ; crop from y position
  296.                           ; (will be adjusted, if >= source height)
  297.                         - CROP_WIDTH=<Value>
  298.                           ; crop how many x pixels from leftedge
  299.                           ; (will be adjusted, if too large)
  300.                         - CROP_HEIGHT=<Value>
  301.                           ; crop how many y pixels from topedge
  302.                           ; (will be adjusted, if too large)
  303.   ----------------------------------------------------------------------------
  304.   ControlPad-Name     : "ENV:superview-library/Dither24Bit.controlpad"
  305.   ControlPad-Commands : - COLORDEPTH=<1..8>
  306.                           ; specifies the colordepth of the dithering
  307.                           ; output (1->2 Colors .. 8->256 Colors)
  308.   ----------------------------------------------------------------------------
  309.   ControlPad-Name     : "ENV:superview-library/ExtractGrayScales.controlpad"
  310.   ControlPad-Commands : - COLORDEPTH=<1..8>
  311.                           ; specifies the colordepth of the grayscaled
  312.                           ; output (1->2 Colors .. 8->256 Colors)
  313.                         - QUICK
  314.                           ; uses >>2, >>1, >>3 (*0.25, *0.5, *0.125)
  315.                           ; instead of *0.3, *0.59, *0.11
  316.   ----------------------------------------------------------------------------
  317.   ControlPad-Name     : "ENV:superview-library/HilbertDither256.controlpad"
  318.   ControlPad-Commands : - BACKGROUND=<BLACK|WHITE>
  319.                           ; defines, which of the two colors will act
  320.                           ; as background color. Useful e.g. for printing.
  321.   ----------------------------------------------------------------------------
  322.   ControlPad-Name     : "ENV:superview-library/PaletteDither.controlpad"
  323.   ControlPad-Commands : - COLORDEPTH=<1..8>
  324.                           ; specifies the colordepth of the final,
  325.                           ; dithered graphics (1..8 for 2..256 colors)
  326.                         - PALETTEDEPTH=<1..8>
  327.                           ; number of colors (depth) to be taken from the
  328.                           ; fixed palette - the possible rest will be
  329.                           ; generated (if specifying more palette colors
  330.                           ; than available, all available will be taken)
  331.                         - PALETTEFILE=<palette graphics filename>
  332.                           ; any 2..256 color graphics file, of which
  333.                           ; superview.library is able to extract a
  334.                           ; palette from (for example an IFF-ILBM file,
  335.                           ; but including a BMHD and - maybe empty - BODY).
  336.                           ; Allows to take one graphics as sample for
  337.                           ; the others (concerning the palette).
  338.   ----------------------------------------------------------------------------
  339.   ControlPad-Name     : "ENV:superview-library/Rotate.controlpad"
  340.   ControlPad-Commands : - DEGREES=<90|180|270>
  341.                           ; rotate by how many degrees (reverse clockwise) ?
  342.   ----------------------------------------------------------------------------
  343.   ControlPad-Name     : "ENV:superview-library/RotateFree.controlpad"
  344.   ControlPad-Commands : - ROTATE_ANGLE=<0..360>
  345.                           ; rotate by how many degrees (reverse clockwise) ?
  346.                         - METHOD=<MIDDLE|GIVENPOINT>
  347.                           ; default is rotation about the middle
  348.                         - X_COORD=<Value>
  349.                           ; if METHOD=GIVENPOINT we need (X/Y)
  350.                           ; Default is (0/0)
  351.                         - Y_COORD=<Value>
  352.                           ; if METHOD=GIVENPOINT we need (X/Y)
  353.                           ; Default is (0/0)
  354.                         - KEEPSIZE
  355.                           ; if this keyword is set, it is NOT tried to
  356.                           ; readjust the image size and to center the
  357.                           ; image, so that parts, which would be out of
  358.                           ; range won't be cut off (which works best
  359.                           ; with (X/Y) pairs in the left, upper quarter)
  360.   ----------------------------------------------------------------------------
  361.   ControlPad-Name     : "ENV:superview-library/Scale50.controlpad"
  362.   ControlPad-Commands : - METHOD=<HALF|DOUBLE>
  363.                           ; scale to which size ?
  364.   ----------------------------------------------------------------------------
  365.   ControlPad-Name     : "ENV:superview-library/XOR.controlpad"
  366.   ControlPad-Commands : - XORVALUE = <0..255>
  367.                           ; 0 and 255 will not be the best decision ;-)
  368.                           ; Use 15 or something like this.
  369.   ----------------------------------------------------------------------------
  370.